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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://ipr.etsi.org ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 



This Technical Specification (TS) has been produced by ETSI Technical Committee Machine-to-Machine 
communications (M2M). 
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Scope 



The present document contains OMA DM [2] compatible management objects for three ETSI M2M mgmtObj 
instances: etsiSclMo M2M-TS 102 690 [4], etsiAreaNwklnfo M2M-TS 102 690 [4] and etsiAi-eaNwkDevicelnfo 
M2M-TS 102 690 [4]. 



References 



References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the 
reference document (including any amendments) applies. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee 
their long term validity. 



2.1 



Normative references 



The following referenced documents are necessary for the application of the present document. 

[1] OMA-WP-AC-MO-20090127-A: "White Paper on Provisioning Objects", January 2009. 

[2] OMA-TS-DM_Protocol-Vl_3-20121009-C: "OMA Device Management Protocol", October 2012. 

NOTE: Available at http://member.openmobilealliance.org/ftp/public documents/dm/DM- 
DM13/Permanent documents/OMA-TS-DM Protocol-Vl 3-20121009-C.zip 



[3] 



[4] 
[5] 
[6] 
[7] 



OMA-TS-DM_TND-V1_3-20121009-C: "OMA Device Management Tree and Description", 
October 2012. 



NOTE: Available at http://member.openmobilealliance.org/ftp/public documents/dm/DM- 
DM13/Permanent documents/OMA-TS-DM TND-Vl 3-20121009-C.zip 



ETSI TS 102 690: "Machine-to-Machine communications (M2M); Functional architecture". 

ETSI TS 102 921: "Machine-to-Machine communications (M2M); mla, dia and mid interfaces". 

Void. 

ISO/IEC/IEEE 9945:2009: "Information technology - Portable Operating System Interface 
(POSIX®) Base Specifications, Issue 7". 



2.2 



Informative references 



The following referenced documents are not necessary for the application of the present document but they assist the 
user with regard to a particular subject area. 



[i.l] 



ETSI TR 102 725: "Machine to Machine Communications (M2M); M2M definitions". 



NOTE: Explanations on the acronyms and abbreviations used in the present document can be found in 
TR 102 725. 
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3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TR 102 725 [i.l] apply. 

3.2 Symbols 

For the purposes of the present document, the symbols given in TR 102 725 [i.l] apply. 

3.3 Abbreviations 

For the purposes of the present document, the abbreviations given in TR 102 725 [i.l] and the following apply: 

DM Device Management 

MANDMO M2M Area Network Device Management Object 

MANMO M2M Area Network Management Object 

MO Management Object 

MSCLMO M2M Service Capability Layer Management Object 

OMA Open Mobile Alliance 

4 General Principles 

In the present document, the following three OMA DM compliant MOs are developed for ETSI M2M: 

• MSCLMO for ETSI M2M etsiSclMo 

• MANMO for ETSI M2M etsiAreaNwklnfo 

• MANDMO for ETSI M2M etsiAreaNwkDevicelnfo 

Based on OMA DM specification on designing a new MO [1], [3], the following rules are followed in the present 
document: 

• MO Identifiers: 

MO identifier for MSCLMO is urn:oma:mo:ext-etsi-msclmo:1.0; 
MO identifier for MANMO is urn:oma:mo:ext-etsi-manmo: 1 .0; 
MO identifier for MANDMO is urn:oma:mo:ext-etsi-mandmo:1.0. 

• Special Handling of resource/attributes in etsiSclMo/etsiAreaNwklnfo/etsiAreaNwkDevicelnfo: 

Subscriptions resource in etsiSclMo/etsiAreaNwklnfo/etsiAreaNwkDevicelnfo will not be modelled in 
MSCLMO/MANMO/MANDMO; 

Several common attributes of a M2M resource in etsiSclMo/etsiAreaNwklnfo/etsiAreaNwkDevicelnfo 
including expirationTime, accessRightID, searchStrings, creationTime, lastModifiedTime, moID, 
originalMO, description, does not occur in MSCLMO/MANMO/MANDMO; 

Collection instances in ctsiSclMo/etsiAreaNwklnfo/etsiAreaNwkDevicelnfo are modelled as an 
unnamed node (i.e. <x>) in MSCLMO/MANMO/MANDMO. 
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Node Properties in MSCLMO/MANMO/MANDMO management tree: 

The Occurrence of a node in MSCLMO/MANMO/MANDMO management tree can be: 

■ ZeroOrOne, ZeroOrMore, ZeroOrN, One, OneOrN, OneOrMore for unnamed node. 

■ Named node can only have ZeroOrOne, or One occurrence since OMA-DM needs each node in a 
management tree shall have a unique URI. 

■ Character Meaning: 

+ 1 ore more occurrences 

* or more occurrences 

? or 1 occurrence 

Each node in MSCLMO/MANMO/MANDMO can have one or more of following access types as 
specified and supported by OMA-DM [2]: 

■ Get, Replace, Exec, Add, Delete, Copy. 

■ A RO (sub-) resource or an attribute is modelled as a node with Get access type. 

■ A RW (sub-) resource or an attribute is modelled as a node with Get and Replace access type. 

■ An attribute standing for an action is modelled as a node with Get and Exec access type. 
The DFFormat of a node in MSCLMO/MANMO/MANDMO management tree can be: 

■ b64, bin, bool, chr, int, node, null, xml, date, time, float: 

> for the leaf node of type 'chr' which is defined as comma separated list: when a comma is 
contained in an item of such a list, the comma shall be escaped by using '\'. 

■ an interior node shall have "node" as its DFFormat value. 

The Status of each node in MSCLMO/MANMO/MANDMO can be "Required" or "Optional" : 

■ An Optional (sub-)resource or attribute is modelled as an Optional node. 

■ A Mandatory (sub-)resource or attribute is modelled as a Required node. 

A node with the name "Ext" is introduced in MSCLMO/MANMO/MANDMO for vendor-specific extension. 



M2M Service Capabilities IVIO 



5.1 IVIO Description 



The M2M SCL MO (MSCLMO) resides in the Management Tree of the any M2M Device or M2M Gateway which 
supports the M2M service capabilities (e.g. DM enablers). This MO corresponds to the etsiSclMo which is an mgmtObj 
resource instance as specified in ETSI M2M functional architecture M2M-TS 102 690 [4]. This MO maintains 
information regarding the management of the M2M service capabilities in M2M Devices and M2M Gateways. 

Figure 1 gives the pictorial description of the MSCLMO. The description of the various nodes within this MO is given 
below. 
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Figure 1 : OMA-DM Compatible SCL lUlO (IVISCLIVIO) 

In what follows the term "time zero" is used to refer to the time of first instantiation of the management object. 



<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


Node 


Get 



This placeholder node is the root node for the IVISCLMO. The parent node of this node defines 

the location of this MO in the IVIanagement Tree. 

The Management Object Identifier for the MSCLMO shall be: "urn:oma:mo:ext-etsi-msclmo;1.0" 



<x>/Operations 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the root node for operations allowed to operate on the MSCLMO. 



<x>/Operations/ReRegistration 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


null 


Get, Exec 



This leaf node is used to trigger a re-registration action. 



<x>/Operations/DeRegistration 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


null 


Get, Exec 



This leaf node is used to trigger a de-registration action. 



<x>/SafPolicySets 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the parent node for all policies related to store-and-forward (SAP). 



<x>/SafPolicySets/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


OneOrMore 


node 


Get 



This interior node is the parent node for a specific store-and-forward (SAP) policy set. At time 
zero one node of this type is present which contains the default policies. The value for the 
"PolicyScope" leaf node (see next paragraph) has to be set to "default". More nodes of this type 
are possible to define policies that are specific to a given request issuer (DA or GA). 
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<x>/SafPolicySets/<x>/PolicyScope 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for ttie scope of an SAF policy set <x>. The value of this leaf node defines 

the scope of the policies contained in the parent node <x> for a specific SAF policy set. 

In case of the default SAF policy set which shall exist at time zero, the value of the PolicyScope 

leaf node shall be the string "default". 

For other SAF policy sets, the value of the PolicyScope leaf node can be set to a list of 

Application IDs, in which case the policies contained in the respective parent SAF policy set node 

are applicable to requests coming from any of the listed applications. 



<x>/SafPolicySets/<x>/M2mSpPolicy 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the parent node for all information related to an SAF policy set controlled by 
the M2M service provider. 



<x>/SafPolicySets/<x>/M2mSpPolicy/DefaultRcatValue 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node is the default value for a request category (Rcat) to be used for requests to 
remotely hosted resources during SAF-handling when no RCAT value was specified in the 
request. In case of the default SAF policy set, this leaf node shall be set to the value "ROATO" at 
time zero. 



<x>/SafPolicySets/<x>/M2mSpPolicy/RcatParamList 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node stands for a list of interior nodes that contain definitions of parameters to be 
used in SAF handling for requests of a given RCAT value. 



<x>/SafPolicySets/<x>/M2mSpPolicy/RcatParamList/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


OneOrMore 


node 


Get 



This interior node stands for a set of parameters that are associated with a given RCAT value. 
The different leafs of this interior node consist of one RCAT value and associated values for 
default TRPDT value, the maximum number of pending requests, the maximum size of buffered 
data and a ranked list of access network names. See details below. At most one interior node 
<x>/SafPolicySets/<x>/l\/l2mSpPolicy/RcatParameters/<x> can exist that contains a leaf node 
<x>/SafPolicySets/<x>/l\/l2mSpPolicy/RcatParameters/<x>/RcatValue with a given RCAT value. 
At time zero exactly one <x>/SafPolicySets/<x>/IVI2MSpPolicy rcatParameters/<x> shall exist for 
each of the possible RCAT values (i.e. one for each on "RCAT_0", "RCAT_1", up to "RCAT_N"; 
N = 8 in the present document). 



<x>/SafPolicySets/<x>/M2mSpPolicy/RcatParamList/<x>/RcatValue 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node contains the RCAT value with which to associate a set of SAF handling 
parameters. The RCAT value is a string for expressing the Request Category to which the other 
SAF parameters under the same interior node apply. At most one interior node 
<x>/SafPolicySets/<x>/IVI2mSpPolicy/RcatParameters/<x> can exist that contains a leaf node 
<x>/SafPolicySets/<x>/l\/l2mSpPolicy/RcatParameters/<x>/ RcatValue with a givenRCAT value. 
In case of the default SAF policy set, the leaf nodes of the N (= number of possible RCAT values) 
interior nodes <x>/SafPolicySets/<x>/IVI2mSpPolicy/RcatParameters/<x> that exists at time zero 
shall be set to different value "RCAT_0" , "RCAT_1", up to "RCAT_N", so that each possible 
RCAT value is represented exactly once. 
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<x>/SafPolicySets/<x>/M2mSpPolicy/ RcatParamList/<x>/DefaultTrpdtValue 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


int 


Get 



This leaf node represents the default duration in seconds that is tolerable for pending of an issued 
request of the associated RCAT value when no specific tolerable delay was specified with the 
request. In case of the default SAF policy set, all N leaf nodes 

<x>/SafPolicySets/<x>/l\/l2mSpPolicy/RcatParameters/<x>/DefaultTrpdtValue that exist at time 
zero shall be set to the value "315360000" (representing 10 years) or larger. 



<x>/SafPolicySets/<x>/M2mSpPolicy/ RcatParamList /<x>/MaxPendReqs 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


int 


Get 



This leaf node represents a threshold for triggering establishment of connectivity by D/GSCL 
defining the maximum number of pending requests in SAF-handling with a request category 
equal to the associated RCAT value. According to the description in M2M-TS 102 690 [4], 
the D/GSCL shall be allowed to trigger establishment of connectivity when more requests have 
been stored than the configured maximum number of pending requests for a given RCAT value. 
In case of the default SAF policy set, no leaf node of this type shall exist at time zero. 



<x>/SafPolicySets/<x>/M2mSpPolicy/ RcatParamList /<x>/MaxPendData 



Status 


Tree Occurrence 


Format 


IVIin. Access Types 


Optional 


ZeroOrOne 


chr 


Get 



This leaf node represents a threshold for triggering establishment of connectivity by D/GSCL 

defining the maximum amount of data used by pending requests in SAF-handling with a request 

category equal to the associated RCAT value. According to the description in 

M2M-TS 102 690 [4], the D/GSCL shall be allowed to trigger establishment of connectivity when 

more data has been used to buffer requests of a given RCAT value than the configured limit for 

the maximum amount of pending data. This leaf node's format is a token comprising of an integer 

with an appended memory unit (B - Bytes, K - 1 024 Bytes, M - 1 048 576 Bytes, 

G -1 073 741 824 Bytes) to be associated with the given RCAT value. 

In case of the default SAF policy set, no leaf node of this type shall exist at time zero. 



<x>/SafPolicySets/<x>/M2mSpPolicy/ RcatParamList /<x>/Ranl<edAnList 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


chr 


Get 



This leaf node represents a ranked list of preferred access networks tokens to be associated 
with the given RCAT value. All tokens in this list are comma separated and each token 
identifies a specific access network. The list governs selection of a preferred access network 
for processing requests of the associated RCAT value that are pending in SAF-handling. The 
ranked list consists of items containing access network names in line with the "anName" 
attributes of <anpPolicy> resources in descending order of preference for the given RCAT 
value. 
In case of the default SAF policy set, no leaf node of this type shall exist at time zero. 

<x>/SafPolicySets/<x>/M2mAnpPolicySets 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the parent node for all information related to SAF-handling policies 
which are controlled by the access network provider. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrMore 


node 


Get 



This interior node is the parent node for all information related to a specific set of SAF-handling 
policies which is controlled by the associated access network provider. In case 
<x>/SafPolicySets/<x> represents the default SAF policy set, no interior node of this type shall 
exist at time zero. 
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<x>/Saf PolicySets/<x>/M2m An p Po I i cySets/<x>/An Name 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for an access networl< name tliat is used by the managed D/GSCL to 
determine for which access networl< the policies defined in this 

<x>/SafPolicySets/<x>/IVI2MAnpPolicySets/<x>/ interior node shall apply. When trying to setup 
connectivity, the D/GSCL needs to be able to use that name internally to establish connectivity 
via the associated access network. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


node 


Get 



This interior node stands for a list of BOAT schedule policy items for defining when it is 
appropriate to use the access network associated with "AnName" for processing requests of 
specific BOAT values. Each item contains one BOAT values and a list of allowed time-spans, 
where the time spans can be defined by a combination of AbsTimeSpans and Schedule time 
spans. Details of the format for BOAT schedule policy items are specified in I\/I2M-TS 102 921 [5]. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Bequired 


OneOrMore 


node 


Get 



This interior node is the parent node for all information about an association between a number of 
allowed time spans and an associatedBGAT value. At most one interior node 
<x>/SafPolicySets/<x>/M2MAnpPolicySets/<x>/BcatSchedList/<x> can exist that contains a leaf 
node <x>/SafPolicySets/<x>/IVI2MAnpPolicySets/<x>/BcatSchedList/<x>/BcatValue with a given 
BOAT value. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/RcatValue 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Bequired 


One 


chr 


Get 



This leaf node contains the BOAT value with which to associate a set of allowed time spans. The 
BOAT value is a string for expressing the Bequest Category to which the time span parameters 
under the same interior node apply. At most one interior node 

<x>/SafPolicySets/<x>/l\/l2mSpPolicy/BcatParameters/<x> can exist that contains a leaf node 
<x>/SafPolicySets/<x>/IVI2mSpPolicy/BcatParameters/<x>/ BcatValue with a given BCAT value. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Bequired 


One 


node 


Get 



This interior node is the parent node for a set of interior nodes that contain schedule items that 
define allowed time spans for the associated BCAT value. Each node under Schedltems defines 
allowed time spans for the associated BCAT value that result from the combination of absolute 
time spans defined under the AbsTimeSpans node along with reoccurring time spans defined in 
the Schedules node. 
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<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


OneOrMore 


node 


Get 



This interior node contains one scliedule item that defines allowed time spans for the associated 
RCAT value. Under this parent node, at least one of following nodes: 

• leaf node "Schedules" as defined below; or 

• interior node "AbsTimeSpans/<x>", 

needs to be populated with information on allowed time spans. 

The Schedules node defines a recurrence of allowed time spans (see below) and the interior 
node AbsTimeSpans contains definitions of absolute time spans (see below), that, if present, 
place constraints on the schedule recurrence. If no Schedules node is present and at least one 
absolute time span is defined in the AbsTimeSpans node, the sum of all time spans defined by 
AbsTimeSpans shall be applied for that instance of Schedltems/<x>. If no absolute time span is 
defined under AbsTimeSpans, the reoccurring time spans in Schedules are not constraint. 
All definitions of absolute time spans under the AbsTimeSpans node shall use the same time 
zone. If AbsTimeSpans does not contain any entries or does not define a specific time zone, UTC 
shall be assumed for all time spans defined in that instance of Schedltems/<x>. The sum of all 
time spans defined by all nodes under Schedltems defines the times when it is appropriate to use 
the access network for processing requests with a request category equal to the associated 
RCAT value. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x>/Schedule 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


chr 


Get 



This leaf node is the comma-separated list of a set of schedule strings. A schedule string Is a 
string formatted according to the CRONTAB input file definition in (ISO/IEG/IEEE 9945:2009 [7]). 
The schedule that is defined by the Schedule string is the sum of all absolute time spans (in one 
minute granularity) that match with the given CRONTAB string. Example of CRONTAB string: "* 
0-6 * * 1-6" would mean the period from 0:00 h to 6:00 h (inclusive) on any week day (Monday 
through Friday) "* 22-23,0-4 * * 1-6" would mean the period from 22:00 h to 04:00 h on any week 
day (Monday through Friday). The reoccurring time spans are the sum of all time spans defined 
by the list of schedule strings. The reoccurring time spans defined in this leaf node are constraint 
by any absolute time spans defined in 

<x>/SafPolicySets/<x>/M2mMAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x>/ 
AbsTimeSpans/<x>, if present. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x>/AbsTimeS 
pans 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node stands for a list of allowed absolute time spans to be associated with the given 
RCAT value. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x>/AbsTimeS 
pa ns/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrMore 


node 


Get 



This interior node is the parent node for all information about a single absolute time span. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x>/AbsTimeS 
pa ns/<x>/StartDate 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


date 


Get 



This leaf node stands for the start date of a single absolute time span in absolute date as defined 
by OMA DM. 



£75/ 



13 



ETSI TS 103 092 VI .2.1 (2013-01) 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x>/AbsTimeS 
pans/<x>/StartTime 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


time 


Get 



This leaf node stands for tine start time of a single absolute time span in absolute time as defined 
by OMA DIVI. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x>/AbsTimeS 
pa ns/<x>/EndDate 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


date 


Get 



This leaf node stands for the end date of a single absolute time span in absolute date as defined 
by OMA DIVI. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/RcatSchedList/<x>/Schedltems/<x>/AbsTimeS 
pa ns/<x>/EndTime 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


time 


Get 



This leaf node stands for the end time of a single absolute time span in absolute time as defined 
by OMA DM. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/BlockPeriods 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


node 


Get 



This interior node stands for a list of block period policy items for defining how long an D/GSCL 
shall wait before re-trying to establish connectivity via the access network associated with 
"AnName" after the previous attempt has failed. Each item consists of a number of consecutive 
failed attempts and a duration. The number of consecutive failed attempts defines how many 
consecutive attempts for establishing connectivity need to have failed in order to apply this block 
policy item and the duration defines how long the next attempt shall be blocked. The D/GSCL 
shall always apply the block policy item with the largest number of consecutive failed attempts 
that is smaller or equal to the actual number of consecutive failed attempts. Details of the format 
for block period policy items are specified in M2M-TS 102 921 [5]. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/BlockPeriods/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


OneOrMore 


node 


Get 



This interior node is the parent node for all information about a number of consecutively failed 
access attempts and a duration that should be used to block the next access attempt. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/BlockPeriods/<x>/FailedAttempts 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


int 


Get 



This leaf node stands for the number of consecutively failed access attempts. 



<x>/SafPolicySets/<x>/M2mAnpPolicySets/<x>/BlockPeriods/<x>/BlockDuration 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


int 


Get 



This leaf node stands for the duration in seconds for which to block further access attempts. 



<x>/RegTargetNsclList 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for a list of NSOLs that the D/G-SGL may use in order to perform a new 
registration (after reboot or not). All values are comma separated and each value stands for a 
specific NSGL. 
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<x>/RegExpirationDuration 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


int 


Get 



This leaf node stands for the duration of the next registration in seconds. The value shall not be 
set to zero. Any negative value stands for infinite duration. 



<x>/RegAccessRightlD 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


chr 


Get 



This leaf node stands for the default accessRightID to be allocated to the <scl> when the <scl> is 
created in the hosting NSCL during the registration procedure of the corresponding D/GSCL. 



<x>/RegSearchStrings 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


chr 


Get 



This leaf node provides an approach to modify the criteria for discovery of D/G-SGL. It stands for 
a list of search strings, which are comma separated. 



<x>/AnnouncedToSclList 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node is used to set default announcedTo-SGL list for D/G-SCL to announce local 
resources to remote SCLs (especially when the application doesn't specify the announceTo 
attribute when creating resources). All values are comma separated and each value stands for a 
specific announcedTo-SCL. 



:x>/MaxNumberOfDiscovRecords 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


int 


Get 



This leaf node stands for the maximum number of resource URIs contained in a discovery result. 



<x>/MaxSizeOfDiscovAnswer 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


int 


Get 



This leaf node stands for the maximum size of the discovery answer. This value is expressed in 
bytes and is useful for very constrained devices. 



<x>/OperationStatus 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the parent node for all information about the status of the operation 
"ReRegistration" (including a progress indicator, a final state and a reminder of the requested 
action). 



<x>/OperationStatus/Operation 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for the link to the operation whose status is represented by 
"OperationStatus". 



<x>/OperationStatus/Progress 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


int 


Get 



This leaf node stands for the progress of the operation in percentage. The range shall be 
between to 1 00. 
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<x>/OperationStatus/FinalStatus 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for tlie final status of the operation. The predefined values are "SUCCESS" 
or "FAILURE". 



<x>/Ext 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


node 


Get 



This interior node is used for vendor-specific extensions to IVISCLMO. 



M2M Area Network MO 



6.1 MO Description 



The M2M Area Network MO (MANMO) resides in the Management Tree of the DM Gateway, which could function as 
an M2M Gateway or an M2M Device with M2M service capabiHties (e.g. DM enablers) according to ETSI M2M 
functional architecture M2M-TS 102 690 [4]. This MO corresponds to the etsiAreaNwklnfo which is an mgmtObj 
resource instance as specified in M2M-TS 102 690 [4]. This MO maintains information regarding the handling of one 
or multiple M2M Area Networks through the DM Gateway. An M2M Area Network may be any type of local area (or 
short range) networks of different technologies (e.g. ZigBee^", m-Bus, WiFi). 

Figure 2 gives the pictorial description of the MANMO. The description of the various nodes within this MO is given 
below. 



— (M21-lIireaNwlrI:^f Q )-p-| HtimOf Areal?w]c3 | 



(interior Hode ] 



I ^AredHwk-3 ~) ( <x>* )-p- | AreaHwkType 



Leaf Node 



AddressT^jpe 



ListOf Devi ces 



I Optional Hode 



S.eq;:;ired Hode 



' AreaHwlcType^nf o ) (<x>*)— |— | ParaiaeterHamg 



ParameterValue 



D 



Figure 2: OMA-DM Compatible M2M Area Networic IVIO (IVIANIVIO) 
M2MAreaNwklnfo 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the root node for the MANMO. The parent node of this node defines the 

location of this MO in the Management Tree. This node and its child nodes contain the 

information for managing an M2M Area Network. 

The Management Object Identifier for the MANMO shall be: 

"urn:oma:mo:ext-etsi--manmo:1.0". 



M2MAreaNwklnfo/NumOfAreaNwl<s 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


int 


Get 



This leaf node stands for the total number of M2M Area Networks behind an M2M Gateway. 



M2MAreaNwklnfo/AreaNwl<s 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the parent node for all information about all M2M Area Networks connecting 
to the same M2M Gateway. 
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M2MAreaNwklnfo/AreaNwks/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


ZeroOrMore 


node 


Get 



This interior node is the parent node for information about a specific M2M Area Networks 
connecting to the same IVI2IVI Gateway. 



M2MAreaNwklnfo/AreaNwks/<x>/AreaNwkType 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for the type of the I\/I2I\/I Area Network. The following enumeration-type 

strings are defined in M2M-TS 102 921 [5]: 6L0WPAN, 6L0WPAN-BLUET00TH, 

6L0WPAN-WIFI, 6L0WPAN-PLC, IPV4-WPAN, IPV4-BLUET00TH, IPV4-WIFI, IPV4-PLG, 

ZIGBEE. 

Note that other types of area networks may be added in the future. 



M2MAreaNwklnfo/AreaNwks/<x>/AddressType 



Status 



Tree Occurrence 



Format 



Min. Access Types 



Required 



One 



chr 



Get 



This leaf node stands for the address type of the M2M Area Network. 



M2MAreaNwklnfo/AreaNwks/<x>/ListOf Devices 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This interior node contains a list of pointers to all devices in this IVI2M Area Network. All values in 
this list are comma separated. Each value stands for a reference to a specific device (i.e. the root 
node <x> of MANDMO as defined in clause 7.1 ). 



M2MAreaNwklnfo/AreaNwks/<x>/AreaNwkTypelnfo 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the placeholder for containing parameters specific to a type of IVI2M Area 
Networks, as denoted by the "AreaNwkType". 



M2MAreaNwklnfo/AreaNwks/<x>/AreaNwkTypelnfo/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


ZeroOrlVlore 


node 


Get 



This interior node stands for a specific parameter. 



M2MAreaNwklnfo/AreaNwks/<x>/AreaNwkTypelnfo/<x>/ParameterName 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for the name of the parameter. 



M2MAreaNwklnfo/AreaNwks/<x>/AreaNwkTypelnfo/<x>/ParameterValue 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for the value of the parameter. 



M2MAreaNwklnfo/Ext 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


node 


Get 



This interior node is used for vendor-specific extensions to IVIANMO. 
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M2M Area Network Device MO 



7.1 



MO Description 



The M2M Area Network Device MO (MANDMO) resides in the Management Tree of the DM Gateway, which could 
function as an M2M Gateway or an M2M Device with M2M service capabilities (e.g. DM enablers) according to ETSI 
M2M functional architecture M2M-TS 102 690 [4]. This MO corresponds to the etsiAreaNwkDevicelnfo which is an 
mgmtObj resource instance as specified in M2M-TS 102 690 [4]. This MO maintains information regarding the 
handling of an M2M Area Network device through the DM Gateway. An M2M Area Network device may be a legacy 
device or a constrained device without M2M service capabilities. Each MANDMO maintains the device information 
pertaining to one or multiple M2M Area Networks that a device is associated with, including both the device 
characteristics and its neighbouring relationship. 

Figure 3 gives the pictorial description of the Device Inventory MO. The description of the various nodes within this 
MO is given below. 
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Figure 3: OMA-DM Compatible M2M Area Network Device l\/IO (l\/IANDI\/IO) 



<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


OneOrMore 


node 


Get 



This interior node is tlie root node for tlie MANDMO. Tlie parent node of this node defines the 
location of this MO in the Management Tree. This node and its child nodes contain the 
information for managing an M2M Area Network device, which is associated with one or multiple 
M2M Area Networks. Each device behind M2M GW should have a corresponding MANDMO. The 
Management Object Identifier for the MANDMO shall be: "urn:oma:mo:ext-etsi-mandmo:1.0". 



<x>/AreaNwks 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the parent node for all information related to all M2M Area Network that the 
device is associated with. 



<x>/AreaNwks/<x> 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


ZeroOrMore 


node 


Get 



This interior node contains information related to a specific M2M Area Network that the device is 
associated with. 



<x>/AreaNwl<s/<x>/AreaNwl<l D 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for the M2M Area Network ID that the device <x> belongs to. 
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<x>/AreaNwks/<x>/Sleeplnterval 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


int 


Get 



This leaf node stands for the sleep interval of the device <x> in seconds. 



<x>/AreaNwks/<x>/SleepDuration 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


int 


Get 



This leaf node stands for the sleep duration of the device <x> in seconds. 



;x>/AreaNwks/<x>/Status 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for the status of the device <x>. It can be ASLEEP or AWAKE. 



<x>/AreaNwks/<x>/Groups 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is used to contain two lists; a list of applications on the device <x> and a list of 
neighbours of the device <x>. 



<x>/AreaNwks/<x>/Groups/ListOfDeviceApplications 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for a list of applications running on the device <x>. All values are comma 
separated and each value stands for a reference to a specific application running on the device 
<x>. 



<x>/AreaNwks/<x>/Groups/ListOfDeviceNeighbors 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


chr 


Get 



This leaf node stands for a list of neighbours of the device <x>. All values are comma separated 
and each value stands for a reference to a specific neighbour device. 



<x>/AreaNwks/<x>/AreaNwkTypelnfoOf Device 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Required 


One 


node 


Get 



This interior node is the placeholder for containing parameters of the device <x> specific to a type 
of M2M Area Network. 



<x >/AreaNwks/<x>/AreaNwkTypelnfoOfDevice/<x> 





Status 


Tree Occurrence 


Format 


Min. Access Types 




Required 


ZeroOrlVlore 


node 


Get 


<x; 


This interior node contains a specific parameter. 
./AreaNwks/<x>/AreaNwkTypelnfoOfDevice/<x>/ParameterName 




Status 


Tree Occurrence 


Format 


Min. Access Types 




Required 


One 


chr 


Get 


<x; 


This leaf node contains the name of a specific parameter. 
./AreaNwks/<x>/AreaNwkTypelnfoOfDevice/<x>/ParameterValue 




Status 


Tree Occurrence 


Format 


Min. Access Types 




Required 


One 


chr 


Get 



This leaf node contains the value of a specific parameter. 
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<x>/Ext 



Status 


Tree Occurrence 


Format 


Min. Access Types 


Optional 


ZeroOrOne 


node 


Get 



This interior node is used for vendor-specific extensions to IVIANDIVIO. 
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